home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / cyb02pdc.zip / CYB02PDC.TTY < prev    next >
Text File  |  1992-07-23  |  8KB  |  164 lines
  1.  
  2.    ▓▓▓▓▓▒ ▓▓▒   ▓▓▒ ▓▓▓▓▓▓▓     ▓▓▓▓▓▓▒ ▓▓▓▓▓▓▓   ▓▓▓▓▓▓▓   ▓▓▓▓▓▓▓     ▓▓▓▓▓▒
  3.   ▓▒▒▒▒▒░ ▓▒░   ▓▒░ ▓▒▒▒▒▒▒░   ▓▒▒▒▒▒▒░ ▓▒▒▒▒▒▒░  ▓▒▒▒▒▒▒░  ▓▒▒▒▒▒▒░   ▓▒▒▒▒▒░
  4.  ▓▒▒░░░░░ ▓▒░   ▓▒░ ▓▒░░░░▒▒░ ▓▒▒░░░░░░ ▓▒░░░░▒▒░ ▓▒░░░░▒▒░ ▓▒░░░░▒▒░ ▓▒▒░░░░░
  5.  ▓▒░      ▓▒░   ▓▒░ ▓▒░   ▓▒░ ▓▒░       ▓▒░   ▓▒░ ▓▒░   ▓▒░ ▓▒░   ▓▒░ ▓▒░
  6.  ▓▒░      ▓▒▒▓▓▓▒▒░ ▓▒▒▓▓▓▒▒░ ▓▒▒▓▓▓▓▒  ▓▒▒▓▓▓▒▒░ ▓▒▒▓▓▓▒▒░ ▓▒░   ▓▒░ ▓▒░
  7.  ▓▒░       ▓▒▒▒▒▒░  ▓▒▒▒▒▒▒░  ▓▒▒▒▒▒▒░  ▓▒▒▒▒▒▒░  ▓▒▒▒▒▒▒░  ▓▒░   ▓▒░ ▓▒░
  8.  ▓▒░        ▓▓▒░░   ▓▒░░░░▒▒░ ▓▒░░░░░░  ▓▒░░░▒▒▒  ▓▒░░░░░   ▓▒░   ▓▒░ ▓▒░
  9.  ▓▒░         ▓▒░    ▓▒░   ▓▒░ ▓▒░       ▓▒░  ▓▒▒░ ▓▒░       ▓▒░   ▓▒░ ▓▒░
  10.  ▓▒▒▓▓▓▓▒    ▓▒░    ▓▒▒▓▓▓▒▒░ ▓▒▒▓▓▓▓▓▒ ▓▒░   ▓▒░ ▓▒░       ▓▒▒▓▓▓▒▒░ ▓▒▒▓▓▓▓▒
  11.   ▓▒▒▒▒▒░    ▓▒░    ▓▒▒▒▒▒▒░   ▓▒▒▒▒▒▒░ ▓▒░   ▓▒░ ▓▒░       ▓▒▒▒▒▒▒░   ▓▒▒▒▒▒░
  12.    ░░░░░░    ▒░░    ▒░░░░░░     ░░░░░░░ ▒░░   ▒░░ ▒░░       ▒░░░░░░     ░░░░░░
  13.  
  14.  
  15.    P C B o a r d   ( F i l e )   D e s c r i p t i o n   C o m p r e s s o r
  16.  
  17.  
  18.              Version 2.00112ß (c) Copyright <<> westsmith 92/7/23
  19.                 The FlatEarth BBS, CyberNET 1:416/803.0,804.0
  20.  
  21.  
  22.  ──────────────────────────────────────────────────────────────────────▄▄▄▄▄▄▄▄
  23.  
  24.    ┌─┐ CYBERPDC
  25.    └─┘ PCBoard (File) Description Compressor
  26.  
  27.   It is not rare to find that user-entered file descriptions, and DIZ files
  28.   themselves, don't use the full 45 column default width that PCBoard allows 
  29.   for file information. Directory listings can usually be compressed into 
  30.   fewer lines by removing extra spaces in the descriptions. This means fewer
  31.   screens of data for users to wade through, and a more efficient and 
  32.   uniform appearance for the file data.
  33.  
  34.   PDC.EXE reads in a PCBoard directory file (that uses default spacing) and
  35.   breaks up the descriptions, writing them to a target file using as few
  36.   lines as possible without actually changing the words of the text.
  37.  
  38.  
  39.  ──────────────────────────────────────────────────────────────────────▄▄▄▄▄▄▄▄
  40.  
  41.    ┌─┐ FILES
  42.    └─┘ Names and Descriptions, FoxPro Information
  43.  
  44.          pdc.exe  45,287 : CYBERPDC 2.00112ß PCBoard (File) Desc. Compressor
  45.          pdc.bas   8,673 : Microsoft QuickBASIC 4.0 source code for PDC.EXE
  46.  
  47.          pdc.prg   4,252 : FoxPro 2.0 source code for PDC.EXE
  48.       browse.prg      70 : FoxPro 2.0 program "do browse," reads FOXDIR.DBF
  49.       pcbdir.dbf     193 : FoxPro 2.0 database, interim step
  50.       foxdir.dbf     225 : FoxPro 2.0 database, final product
  51.       foxdir.fpt     512 : FoxPro 2.0 memo fields for FOXDIR.DBF
  52.  
  53.     cyb02pdc.tty   8,153 : This document
  54.  
  55.   The only file actually required for CYBERPDC to run is PDC.EXE. I would 
  56.   also recommend that you keep a copy of this document until you've read it
  57.   and are comfortable with the utility.
  58.  
  59.   The second group of files are essentially a non-compiled version of the 
  60.   same program, but written in Fox (Microsoft now?) Software's FoxPro 2.00.
  61.   While PDC.PRG should port to any xBase-standard dialect², the DBFs don't
  62.   seem to be completely compatible. If you're trying to port out of Fox
  63.   and can't read the DBF's, you can re-create them:
  64.  
  65.       Structure for database: C:\SUB\CYB02PDC\PCBDIR.DBF
  66.       Number of data records:       0
  67.       Date of last update   : 07/23/92
  68.       Field  Field Name  Type       Width    Dec    Index
  69.           1  FILE        Character     13            
  70.           2  SIZE        Numeric        8            
  71.           3  DATE        Character     10            
  72.           4  P           Character      2            
  73.           5  DESC        Character     45            
  74.       ** Total **                      79
  75.  
  76.       Structure for database: C:\SUB\CYB02PDC\FOXDIR.DBF
  77.       Number of data records:       0
  78.       Date of last update   : 07/23/92
  79.       Memo file block size  :      64
  80.       Field  Field Name  Type       Width    Dec    Index
  81.           1  NAME        Character      8            
  82.           2  EXT         Character      3            
  83.           3  SIZE        Numeric        8            
  84.           4  DATE        Date           8            
  85.           5  DESC        Memo          10            
  86.           6  UPLOADER    Character     32            
  87.       ** Total **                      70
  88.   
  89.   Additionally, you'll likely have a problem with the extended switches
  90.   in BROWSE.PRG if you try to run it outside of FoxPro. The second-to-last
  91.   field element is a temporary detail on the first line of the memo field
  92.   attached to each file-record.
  93.  
  94.   The FoxPro code is significantly slower than its Microsoft QuickBASIC
  95.   counterpart. Because of this, and because a user's likely destination in
  96.   FoxPro will be to generate a DBF file from the PCBoard directory, I did
  97.   not include a routine in PDC.PRG to write back a compressed PCB DIR.
  98.  
  99.      ² - I've made brief use of FoxPro's windowing system. There are two 
  100.          calls in the main body of the code, and another in the HURL 
  101.          procedure. To port out of Fox, you'll need to change these as
  102.          your chosen dialect allows.
  103.  
  104.  
  105.  ──────────────────────────────────────────────────────────────────────▄▄▄▄▄▄▄▄
  106.  
  107.    ┌─┐ HISTORY 
  108.    └─┘ Version List, Bug Fixes
  109.  
  110.   92/07/20 - Original Release.
  111.   CYBERPDC
  112.   1.00263ß   CYBER???'s are built on a standard program frame that I drew
  113.              up over a year ago. Some portions of the code may seem a bit
  114.              overdone or unnecessary; most of the routines were designed to
  115.              be flexible and handle whatever was required for each different
  116.              utility.
  117.  
  118.              After spending a year and a half freely trading utilities and
  119.              code with other Telegard BBS users and the Fido community, I was
  120.              rather shocked upon entering the PCBoard arena to find that it
  121.              seems to lack entirely a "support," community.
  122.  
  123.              Everyone and their dog has written something for PCBoard, but
  124.              most tools are crippled, encrypted and released without source.
  125.              There seems to be more emphasis on turning a buck than rolling
  126.              the computer-wheel out of the stone age. It's not uncommon to
  127.              find a dozen utilities for PCBoard with precisely the same
  128.              purpose, each crippled until users send in $20, coded very
  129.              likely because each new author didn't want to send in $20 the
  130.              the last guy.
  131.  
  132.              For major software efforts, charging (reasonable) rates is
  133.              unavoidable (although counter-evolutionary, silicon-wise).
  134.              For small stuff that someone burns out in a day or 3, charging
  135.              register cash is petty and not at all conducive towards
  136.              encouraging people to use the work.
  137.  
  138.              The result seems to be a lot of developers starting from
  139.              Ground-Zero all the time. Disappointing, to say the least.
  140.  
  141.              CYBERPDC.EXE is hardly rocket science, but if anyone can make
  142.              use of the code and go a step further, go for it. I'd appreciate
  143.              only a copy of your program and perhaps notice for having coded
  144.              the original few lines.
  145.  
  146.   92/07/23 - Bug Fix. Discovered (too late) that the "Uploaded by:" exception
  147.   2.00112ß   processing wasn't working properly. The read cycle collects
  148.   CYB02PDC   description data until encountering EOF or the next filename,
  149.              before finally reducing and printing off to file. The check for
  150.              "Uploaded by:" on the other hand, was tossing off a line to
  151.              output as soon as it was found. File blocks were coming out with
  152.              the "Uploaded by: " line first, then the file specs, and finally
  153.              the descriptions.
  154.              
  155.              A few lines from the standard frame (see Original Release) were
  156.              removed to free up a bit more memory.
  157.  
  158.   92/07/23 - Parallel code written in FoxPro 2.0. PDC.PRG will generate a 
  159.   2.00113ß   DBF (and memo composite) from a PCBoard directory, instead of
  160.   CYB02PDC   another compressed PCB DIR file.
  161.  
  162.                                     - fin -
  163.  
  164.